tw2html
                                Version 1.0
                          (C)1997 Adrian O' Neill

Introduction
------------

TransWrite is an old Amiga wordprocessor that was quite popular - I think
many companies gave it away free!  It was very good (i.e. it didn't crash
every five minutes) and I still use it very frequently as it is so easy to
use.  It has loads of simple features, such as underlining text,
justification etc.

Anyway, when I started to put stuff out on the Internet I needed a way to
convert all my old TransWrite files to HTML format, the standard that the
WWW uses.  So I wrote tw2html, and I'm now releasing it as freeware.  I
hope you find it useful.

The program allows you to take any file that TransWrite has saved and
convert it directly into HTML.  This program should be of use to both those
who have no experience with the WWW and want to publish their TW files
without having to learn anything about HTML, and those who just want a
quick way to take TW files to HTML then fiddle about with them!


Usage
-----

Copy the file tw2html to your C: directory (or wherever you keep your CLI
commands).  Then from a CLI window type:

tw2html filename

where filename is the name of any TW file.  You should then find in the
directory where the original file was a new file, filename.html.  This file
is the HTML version of the original file, ready for use on the 'net!

You can also specify the name of the HTML file that will be produced, so
for example you could use the command:

tw2html df0:filename ram:newfile.html

to convert the file to HTML format and store the results in the ram disk.


Distribution
------------

This program can be considered freely distributable, subject to the
following:

1. The program must be distributed fully, unmodified with all copyright
intact.

2. Please don't make modifications then redistribute - submit the
modifications to me and then I'll redistribute.


Disclaimer
----------

PROGRAM DISCLAIMER: THE PROGRAMS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF ANY PROGRAM IS ASSUMED
BY YOU.  Should the programs prove defective, you (and not the author of
these programs) assume the entire cost of all necessary servicing, repair,
or correction.  Further, the author of these programs does not warrant,
guarantee, or makes any representation regarding the use of, or the results
of the use of, the programs in terms of corrections, accuracy, reliability,
currentness, or otherwise; and you rely on the programs and results solely
at your own risk.


Adrian's Development Pages
--------------------------

If you use tw2html and you like it, then all I ask in return is that you
send me an e-mail telling me so!  My address is:

                              aon@bigfoot.com

Also, if you have a home page on the Internet, then please send me the URL
and I'll add it to the list I maintain on my development pages of all the
home pages of people that use my software.  The list can be found by
following the link at:

     http://www.geocities.com/SiliconValley/Way/2374/development.html

(anyone using amosaic or another ancient browser - if you see nothing when
you access the page above, then access the page n_development in the same
directory).


Source
------

Source code to tw2html is included.  It was compiled under DICE but should
be ok for any ANSI-C compiler.  If you have any problems porting, please
let me know!


Limitations
-----------

Strange things may happen if you have paragraphs over 5K!  Also, tw2html
only understands the formatting codes jl, jr, jc and jf - all other codes
are ignored.  If you can suggest suitable HTML for any other formatting
code, please let me know!  The program also makes many assumptions, and can
only give a rough style translation of most documents due to the nature of
HTML.


Contacting Me
-------------

I'm Adrian O' Neill.  My e-mail address is aon@bigfoot.com - please let me
know if you have any comments about this program or life in general.  My
home page:

              http://www.geocities.com/SiliconValley/Way/2374

I also publish FileConv, util/conv/FileConv.lha on the Aminet.